home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / uadmin.z / uadmin
Encoding:
Text File  |  2002-10-03  |  5.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. uuuuaaaaddddmmmmiiiinnnn((((2222))))                                                            uuuuaaaaddddmmmmiiiinnnn((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _uuuu_aaaa_dddd_mmmm_iiii_nnnn - administrative control
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_uuuu_aaaa_dddd_mmmm_iiii_nnnn_...._hhhh_>>>>
  13.  
  14.      _iiii_nnnn_tttt _uuuu_aaaa_dddd_mmmm_iiii_nnnn_((((_iiii_nnnn_tttt _cccc_mmmm_dddd_,,,, _iiii_nnnn_tttt _ffff_cccc_nnnn_,,,, _iiii_nnnn_tttt _mmmm_dddd_eeee_pppp_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _uuuu_aaaa_dddd_mmmm_iiii_nnnn provides control for basic administrative functions.  This system
  18.      call is tightly coupled to the system administrative procedures and is
  19.      not intended for general use.  The argument _m_d_e_p is provided for
  20.      machine-dependent use and is not defined here.
  21.  
  22.      As specified by _c_m_d, the following commands are available:
  23.  
  24.      _AAAA______SSSS_HHHH_UUUU_TTTT_DDDD_OOOO_WWWW_NNNN     The system is shut down.  All user processes are killed,
  25.                     the buffer cache is flushed, and the root file system (and
  26.                     no other) is unmounted.  The action to be taken after the
  27.                     system has been shut down is specified by _f_c_n.  The
  28.                     functions are generic; the hardware capabilities vary on
  29.                     specific machines.
  30.  
  31.                     _AAAA_DDDD______HHHH_AAAA_LLLL_TTTT     Halt the system.
  32.  
  33.                     _AAAA_DDDD______BBBB_OOOO_OOOO_TTTT     Reboot the system.
  34.  
  35.                     _AAAA_DDDD______IIII_BBBB_OOOO_OOOO_TTTT    Interactive reboot; the system goes to
  36.                                 firmware mode and the user is prompted for
  37.                                 bootable program name.  Not supported; it is
  38.                                 treated the same as _AAAA_DDDD______HHHH_AAAA_LLLL_TTTT_....
  39.  
  40.                     _AAAA_DDDD______PPPP_OOOO_WWWW_EEEE_RRRR_OOOO_FFFF_FFFF Halt the processor and turn off the power with
  41.                                 _AAAA______RRRR_EEEE_BBBB_OOOO_OOOO_TTTT or _AAAA______SSSS_HHHH_UUUU_TTTT_DDDD_OOOO_WWWW_NNNN.  With _AAAA______SSSS_EEEE_TTTT_FFFF_LLLL_AAAA_GGGG,
  42.                                 simply sets the flag so that a subsequent
  43.                                 _AAAA______SSSS_HHHH_UUUU_TTTT_DDDD_OOOO_WWWW_NNNN or _AAAA______RRRR_EEEE_BBBB_OOOO_OOOO_TTTT also powers off.
  44.  
  45.      _AAAA______RRRR_EEEE_BBBB_OOOO_OOOO_TTTT       The system stops immediately without any further
  46.                     processing.  The action to be taken next is specified by
  47.                     _f_c_n as above.
  48.  
  49.      _AAAA______RRRR_EEEE_MMMM_OOOO_UUUU_NNNN_TTTT      The root file system is mounted again after having been
  50.                     fixed.  This should be used only during the startup
  51.                     process.
  52.  
  53.      _AAAA______KKKK_IIII_LLLL_LLLL_AAAA_LLLL_LLLL      All processes are killed except those belonging to the
  54.                     process group specified by _f_c_n.  They are sent the signal
  55.                     specified by _m_d_e_p.
  56.  
  57.      _AAAA______SSSS_EEEE_TTTT_FFFF_LLLL_AAAA_GGGG      Set a flag to control later actions.  Currently
  58.                     implemented only for _AAAA_DDDD______PPPP_OOOO_WWWW_EEEE_RRRR_OOOO_FFFF_FFFF.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. uuuuaaaaddddmmmmiiiinnnn((((2222))))                                                            uuuuaaaaddddmmmmiiiinnnn((((2222))))
  71.  
  72.  
  73.  
  74.      _uuuu_aaaa_dddd_mmmm_iiii_nnnn fails if any of the following are true:
  75.  
  76.      _EEEE_PPPP_EEEE_RRRR_MMMM          The calling process does not have super-user privilege.
  77.  
  78. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  79.      Upon successful completion, the value returned depends on _c_m_d as follows:
  80.  
  81.           _AAAA______SSSS_HHHH_UUUU_TTTT_DDDD_OOOO_WWWW_NNNN   Never returns.
  82.           _AAAA______RRRR_EEEE_BBBB_OOOO_OOOO_TTTT     Never returns.
  83.           _AAAA______RRRR_EEEE_MMMM_OOOO_UUUU_NNNN_TTTT    0
  84.           _AAAA______KKKK_IIII_LLLL_LLLL_AAAA_LLLL_LLLL    0
  85.  
  86.      Otherwise, a value of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the
  87.      error.
  88.  
  89. CCCCAAAAPPPPAAAABBBBIIIILLLLIIIITTTTIIIIEEEESSSS
  90.      Require the following in the permitted capability set:
  91.  
  92.      CCCCAAAAPPPP____SSSSHHHHUUUUTTTTDDDDOOOOWWWWNNNN   Privilege to shutdown or reboot the system.
  93.  
  94. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  95.      syssgi(2), uadmin(1), capabilities(4).
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.